home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / paste.z / paste
Text File  |  1998-10-20  |  7KB  |  133 lines
  1.  
  2.  
  3.  
  4. ppppaaaasssstttteeee((((1111))))                                                              ppppaaaasssstttteeee((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _pppp_aaaa_ssss_tttt_eeee - merge same lines of several files or subsequent lines of one file
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _pppp_aaaa_ssss_tttt_eeee _----|_f_i_l_e_1  _----|_f_i_l_e_2  . . .
  13.      _pppp_aaaa_ssss_tttt_eeee _----_dddd_l_i_s_t _----|_f_i_l_e_1  _----|_f_i_l_e_2  . . .
  14.      _pppp_aaaa_ssss_tttt_eeee _----_ssss _[[[[_----_dddd_l_i_s_t] _----|_f_i_l_e_1 . . .
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      In the first two forms, _pppp_aaaa_ssss_tttt_eeee concatenates corresponding lines of the
  18.      given input files _f_i_l_e_1, _f_i_l_e_2, and so on.  It treats each file as a
  19.      column or columns of a table and pastes them together horizontally
  20.      (parallel merging).  If you will, it is the counterpart of _cccc_aaaa_tttt(1) which
  21.      concatenates vertically, that is, one file after the other.  In the last
  22.      form above, _pppp_aaaa_ssss_tttt_eeee replaces the function of an older command with the same
  23.      name by combining subsequent lines of the input file (serial merging).
  24.      If more than one file is specified with the _----_ssss option, _pppp_aaaa_ssss_tttt_eeee(1)
  25.      concatenates the merged files one below the other.  In all cases, lines
  26.      are glued together with the _t_a_b character, or with characters from an
  27.      optionally specified _l_i_s_t.  Output is to the standard output, so it can
  28.      be used as the start of a pipe, or as a filter, if _---- is used in place of
  29.      a file name.  _pppp_aaaa_ssss_tttt_eeee processes supplementary code set characters in _f_i_l_e_s,
  30.      and recognizes supplementary code set characters in the _l_i_s_t given to the
  31.      _----_dddd option (see below) according to the locale specified in the _LLLL_CCCC______CCCC_TTTT_YYYY_PPPP_EEEE
  32.      environment variable [see _LLLL_AAAA_NNNN_GGGG on _eeee_nnnn_vvvv_iiii_rrrr_oooo_nnnn(5)].
  33.  
  34.      The meanings of the options are:
  35.  
  36.      _----_dddd   Without this option, the new-line characters of each but the last
  37.           file (or last line in case of the _----_ssss option) are replaced by a _t_a_b
  38.           character.  This option allows replacing the _t_a_b character by one or
  39.           more alternate characters (see below).
  40.  
  41.      _l_i_s_t One or more characters immediately following _----_dddd replace the default
  42.           _t_a_b as the line concatenation character.  The list is used
  43.           sequentially and circularly: first, the first element on the list is
  44.           used to concatenate the lines, then the next, and so on; when all
  45.           elements have been used, the list is reused starting from the first
  46.           element.  In parallel merging (that is, no _----_ssss option), the lines
  47.           from the last file are always terminated with a new-line character,
  48.           not from the _l_i_s_t.  The list may contain the special escape
  49.           sequences:  _\\\\_nnnn (new-line), _\\\\_tttt (tab), _\\\\_\\\\ (backslash), and _\\\\_0000 (empty
  50.           string, not a null character).  Quoting may be necessary, if
  51.           characters have special meaning to the shell (for example, to get
  52.           one backslash, use -_d"\\\\" ).  _l_i_s_t may contain supplementary code
  53.           set characters.
  54.  
  55.      _----_ssss   Merge subsequent lines rather than one from each input file.  Use
  56.           _t_a_b for concatenation, unless a _l_i_s_t is specified with _----_dddd option.
  57.           Regardless of the _l_i_s_t, the very last character of the file is
  58.           forced to be a new-line.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ppppaaaasssstttteeee((((1111))))                                                              ppppaaaasssstttteeee((((1111))))
  71.  
  72.  
  73.  
  74.      _----    May be used in place of any file name, to read a line from the
  75.           standard input.  (There is no prompting).
  76.  
  77. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  78.      _llll_ssss _|||| _pppp_aaaa_ssss_tttt_eeee _----_dddd_"""" _"""" _----
  79.                     Lists directory in one column
  80.  
  81.      _llll_ssss _|||| _pppp_aaaa_ssss_tttt_eeee _---- _---- _---- _----
  82.                     Lists directory in four columns
  83.  
  84.      _pppp_aaaa_ssss_tttt_eeee _----_dddd_""""_\\\\_tttt_\\\\_nnnn_"""" _f_i_l_e_1 _f_i_l_e_2
  85.                     Lists _f_i_l_e_1 in column 1 and _f_i_l_e_2 in column 2.  The
  86.                     columns are separated by a tab.
  87.  
  88.      _pppp_aaaa_ssss_tttt_eeee _----_ssss _----_dddd_""""_\\\\_tttt_\\\\_nnnn_"""" _f_i_l_e_1 _f_i_l_e_2
  89.                     Merges pairs of subsequent lines first in _f_i_l_e_1, then in
  90.                     _f_i_l_e_2.  Concatenates the merged _f_i_l_e_2 below _f_i_l_e_1.
  91.  
  92. FFFFIIIILLLLEEEESSSS
  93.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_llll_oooo_cccc_aaaa_llll_eeee_////_l_o_c_a_l_e_////_LLLL_CCCC______MMMM_EEEE_SSSS_SSSS_AAAA_GGGG_EEEE_SSSS_////_uuuu_xxxx_dddd_ffff_mmmm
  94.           language-specific message file [See _LLLL_AAAA_NNNN_GGGG on _eeee_nnnn_vvvv_iiii_rrrr_oooo_nnnn(5).]
  95.  
  96. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  97.      _cccc_uuuu_tttt(1), _gggg_rrrr_eeee_pppp(1), _pppp_rrrr(1)
  98.  
  99. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  100.      _UUUU_XXXX_::::_pppp_aaaa_ssss_tttt_eeee_::::_EEEE_RRRR_RRRR_OOOO_RRRR_::::_llll_iiii_nnnn_eeee _tttt_oooo_oooo _llll_oooo_nnnn_gggg
  101.           Output lines are restricted to 4096 bytes.
  102.  
  103.      _UUUU_XXXX_::::_pppp_aaaa_ssss_tttt_eeee_::::_EEEE_RRRR_RRRR_OOOO_RRRR_::::_tttt_oooo_oooo _mmmm_aaaa_nnnn_yyyy _ffff_iiii_llll_eeee_ssss
  104.           Except for _----_ssss option, no more than 12 input files may be specified.
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.